home *** CD-ROM | disk | FTP | other *** search
/ SGI Desktop Special Edition 1.0 / SGI Desktop Special Edition 1.0.iso / relnotes / insight / ch2.z / ch2
Text File  |  1995-09-11  |  36KB  |  722 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information that is supplemental to the
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e and the
  12.        installation instructions in the _P_e_r_s_o_n_a_l _S_y_s_t_e_m
  13.        _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  14.        product-specific; use it with either of those Guides to
  15.        install this product.
  16.  
  17.        Note:  Products such as the Support Partner Advantage
  18.               (ptnr_lib) CD and the Support Advantage (supp_lib) CD
  19.               contain their own release notes which should be
  20.               consulted and used in conjunction with the IRIS
  21.               InSight Viewer release notes.  Please read those
  22.               first for preliminary installation information.
  23.  
  24.  
  25.        2.1  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m_s
  26.  
  27.        The IRIS InSight product family includes these subsystems:
  28.  
  29.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p      SGIHelp help application
  30.                                      information
  31.  
  32.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p            IRIS InSight help
  33.  
  34.        _i_n_s_i_g_h_t._m_a_n._m_a_n               IRIS InSight man pages
  35.  
  36.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s          The online version of these
  37.                                      release notes
  38.  
  39.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t             IRIS InSight viewer software
  40.  
  41.        _i_n_s_i_g_h_t._s_w._d_a_t_a               IRIS InSight shared data files
  42.  
  43.        _i_n_s_i_g_h_t._s_w._p_u_b_l_i_c             IRIS InSight data files
  44.  
  45.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p            SGIHelp and DesktopHelp
  46.                                      software
  47.  
  48.        _i_n_s_i_g_h_t._s_w._t_t_n_a_v              Topic/Task Navigator software
  49.  
  50.        Help content for the IndigoMagic Desktop is retrieved from
  51.        the following IRIS InSight books (subject to change):
  52.  
  53.        _d_e_s_k_t_o_p__e_o_e._b_o_o_k_s.*           IndigoMagic Desktop Books
  54.  
  55.        _d_e_s_k_t_o_p__t_o_o_l_s._b_o_o_k_s.*         Desktop Tools Books
  56.  
  57.        _d_m_e_d_i_a__e_o_e._b_o_o_k_s.*            Media Control Panels
  58.                                      Help/User's Guide
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        _d_m_e_d_i_a__t_o_o_l_s._b_o_o_k_s.*          Media Tools Help/User's Guide
  75.  
  76.        _i_m_g_t_o_o_l_s._b_o_o_k_s.*              ImageVision Tools Help
  77.  
  78.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p            IRIS InSight Viewer Help
  79.  
  80.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p      SGIHelp Help
  81.  
  82.        _i_n_s_i_g_h_t__g_l_o_s_s._b_o_o_k_s._g_l_o_b_a_l    IRIS InSight Glossary of Terms
  83.  
  84.        _m_m_a_i_l._b_o_o_k_s._M_e_d_i_a_M_a_i_l_H_e_l_p     MediaMail Books
  85.  
  86.        _s_y_s_m_o_n._b_o_o_k_s.*                Desktop System Monitor Help
  87.  
  88.  
  89.        2.2  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  90.  
  91.        This section lists the subsystems (and their sizes) of the
  92.        IRIS InSight software.
  93.  
  94.        You can use the software installation instructions in the
  95.        _P_e_r_s_o_n_a_l _S_y_s_t_e_m _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e to install this
  96.        product.  If you are installing this software for the first
  97.        time, the default subsystems are installed if you click the
  98.        _I_n_s_t_a_l_l _A_u_t_o_m_a_t_i_c_a_l_l_y button.  To install a different set of
  99.        subsystems, click the _C_u_s_t_o_m_i_z_e _I_n_s_t_a_l_l_a_t_i_o_n button and make
  100.        your new selections.  Then click the _S_t_a_r_t button to launch
  101.        the installation.
  102.  
  103.        Note:  The listed subsystem sizes are approximate. Refer to
  104.               the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e for
  105.               information on finding exact sizes.
  106.  
  107.        Subsystem Name                Subsystem Size
  108.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p            275
  109.        _i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p                  420
  110.        _i_n_s_i_g_h_t._m_a_n._m_a_n                      20
  111.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s                 30
  112.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t                  4310
  113.        _i_n_s_i_g_h_t._s_w._d_a_t_a                     600
  114.        _i_n_s_i_g_h_t._s_w._p_u_b_l_i_c                   430
  115.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p                 4895
  116.        _i_n_s_i_g_h_t._s_w._t_t_n_a_v                    210
  117.  
  118.  
  119.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                   - 3 -
  132.  
  133.  
  134.  
  135.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  136.  
  137.        All of the subsystems for IRIS InSight can be installed
  138.        using IRIX.  You do not need to use the miniroot. Refer to
  139.        the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e or the
  140.        installation instructions in the _P_e_r_s_o_n_a_l _S_y_s_t_e_m
  141.        _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e for complete installation instructions.
  142.  
  143.  
  144.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  145.  
  146.        Your workstation must be running release 4D1-5.3 in order to
  147.        use release 2.3.1 of IRIS InSight.
  148.  
  149.        If you want to install the IRIS InSight viewer
  150.        (_i_n_s_i_g_h_t._s_w._c_l_i_e_n_t) then you must also install _x__e_o_e._s_w._e_o_e,
  151.        _m_o_t_i_f__e_o_e._s_w._e_o_e, _e_o_e_1._s_w._i_r_i_x__l_i_b,
  152.        _d_m_e_d_i_a__e_o_e._s_w._c_o_m_p_r_e_s_s_i_o_n, _d_m_e_d_i_a__e_o_e._s_w._c_o_m_m_o_n,
  153.        _d_m_e_d_i_a__e_o_e._s_w._a_u_d_i_o, _c_o_m_p_i_l_e_r__e_o_e._s_w._l_i_b, _c++__e_o_e._s_w._l_i_b,
  154.        and _V_i_e_w_K_i_t__e_o_e._s_w._b_a_s_e for the viewer to function properly.
  155.        If you want to view any of the inline Inventor media objects
  156.        then you must install _i_n_v_e_n_t_o_r__e_o_e._s_w._i_n_v_e_n_t_o_r.  If you want
  157.        to view any of the inline movie objects then you must
  158.        install _e_o_e_1._s_w._g_f_x__l_i_b. If you want to install the online
  159.        help (_i_n_s_i_g_h_t._b_o_o_k_s._h_e_l_p) for the IRIS InSight viewer then
  160.        you must install _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p along with the viewer.
  161.  
  162.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  163.  
  164.        The IRIS InSight 2.X viewers are incompatible with the IRIS
  165.        InSight 1.0 books.  You will not be able to install the
  166.        older 1.0 books after a 2.X viewer is installed, due to
  167.        incompatibility rules during installation.  However, we have
  168.        no means of preventing users from mounting 1.0 books onto a
  169.        2.X viewer's filesystem.
  170.  
  171.        It is also possible to mount and access the 5.3 books from a
  172.        5.2 system, however the help for applications may not work
  173.        due to changes in the applications and documentation between
  174.        the two operating systems.  The same is also true for 5.2
  175.        help books being accessed from 5.3 applications.
  176.  
  177.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  178.  
  179.        You can install IRIS InSight in five configurations:
  180.  
  181.           +o Local client and server
  182.  
  183.           +o Client with remote server
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                   - 4 -
  198.  
  199.  
  200.  
  201.           +o Client with server on CD-ROM
  202.  
  203.           +o Creating an InSight document server
  204.  
  205.           +o Client accessing books from multiple locations
  206.  
  207.        Important: Please read this section carefully. It details
  208.                   installation information specific to the IRIS
  209.                   InSight product.
  210.  
  211.        2.6.1  _L_o_c_a_l__C_l_i_e_n_t__a_n_d__S_e_r_v_e_r  The default installation
  212.        configuration is to install the IRIS InSight Viewer and
  213.        Document Library on a single system.  The total size of the
  214.        viewer, glossary, and help is a little more than 11 Mb.
  215.        Installing additional books requires additional disk space.
  216.        If you have the disk space, this is the ideal configuration
  217.        since it gives the viewer fastest access to the book data.
  218.        See the Release Notes for products that contain books to
  219.        find out the disk space requirements for each book.
  220.  
  221.        2.6.2  _C_l_i_e_n_t__w_i_t_h__R_e_m_o_t_e__S_e_r_v_e_r  If several machines plan
  222.        on sharing all the books, helpmap files, and man pages via
  223.        NFS mounts then this is the configuration of choice.  To
  224.        install the IRIS InSight Viewer and Document Library on a
  225.        remote server and access the information from a local client
  226.        system, follow these steps:
  227.  
  228.          1.  On the server:
  229.  
  230.                a.  Install the complete IRIS InSight product image
  231.                    and all books.
  232.  
  233.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt ****....bbbbooooooookkkkssss....****
  234.  
  235.                b.  Export the /_u_s_r/_s_h_a_r_e directory using the System
  236.                    Manager.
  237.  
  238.          2.  On the client:
  239.  
  240.                a.  Install the _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t subsystem (you
  241.                    might want to install the _i_n_s_i_g_h_t._m_a_n._m_a_n and
  242.                    the _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s subsystems as well).
  243.  
  244.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp iiiinnnnssssiiiigggghhhhtttt iiiinnnnssssiiiigggghhhhtttt____gggglllloooossssssss
  245.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....cccclllliiiieeeennnntttt
  246.  
  247.                b.  Mount <_s_e_r_v_e_r>:/_u_s_r/_s_h_a_r_e on /_u_s_r/_s_h_a_r_e.
  248.  
  249.                    mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee ////uuuussssrrrr////sssshhhhaaaarrrreeee
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                   - 5 -
  264.  
  265.  
  266.  
  267.        2.6.3  _C_l_i_e_n_t__w_i_t_h__S_e_r_v_e_r__o_n__C_D_-_R_O_M
  268.  
  269.        Note:  If you have a version of the IRIS InSight Document
  270.               Library installed on your disk but want to mount the
  271.               books from the CD-ROM, you must remove all the
  272.               current IRIS InSight books (with the IRIX command
  273.               _v_e_r_s_i_o_n_s _r_e_m_o_v_e) from your system and remove any
  274.               remaining files in /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y before
  275.               creating the symbolic link described in step 2.
  276.  
  277.        If you wish to use the IRIS InSight Viewer and Document
  278.        Library from the CD-ROM and access the information from a
  279.        local or remote system, follow these steps:
  280.  
  281.          1.  On the system with the CD-ROM drive, insert the IRIS
  282.              InSight CD into the CD-ROM drive.
  283.  
  284.              If the drive is not mounted, use the System Manager to
  285.              mount the drive.  The most common mount point is
  286.              /_C_D_R_O_M.
  287.  
  288.              If the drive is mounted correctly, you should be able
  289.              to change directories to /_C_D_R_O_M and see all the files
  290.              in the IRIS InSight CD:
  291.  
  292.              ccccdddd ////CCCCDDDDRRRROOOOMMMM
  293.              llllssss
  294.  
  295.          2.  As root create a symbolic link from
  296.              /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s to the CD
  297.              mount point for the _i_n_s_i_g_h_t directory.  You may need
  298.              to create the directory /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y if
  299.              it doesn't exist.
  300.  
  301.              mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  302.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  303.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  304.  
  305.          3.  As root create a symbolic link from /_u_s_r/_s_h_a_r_e/_h_e_l_p to
  306.              the CD mount point for the _h_e_l_p directory.
  307.  
  308.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  309.  
  310.              If you are sharing this CD-ROM mount point with other
  311.              users on your network, export the root (``/'')
  312.              directory and the /_C_D_R_O_M directory using the System
  313.              Manager.
  314.  
  315.          4.  On each client:
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                   - 6 -
  330.  
  331.  
  332.  
  333.                a.  Install the _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t,
  334.                    _i_n_s_i_g_h_t._s_w._p_u_b_l_i_c, and _i_n_s_i_g_h_t._s_w._d_a_t_a
  335.                    subsystems (you might want to install the
  336.                    _i_n_s_i_g_h_t._m_a_n._m_a_n and the _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s
  337.                    subsystems as well).  You can get the
  338.                    installation software from the CD in the
  339.                    /_C_D_R_O_M/_d_i_s_t directory.
  340.  
  341.                    ssssuuuu
  342.                    iiiinnnnsssstttt ----ffff ////CCCCDDDDRRRROOOOMMMM////ddddiiiisssstttt
  343.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp ****
  344.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....cccclllliiiieeeennnntttt iiiinnnnssssiiiigggghhhhtttt....sssswwww....ddddaaaattttaaaa iiiinnnnssssiiiigggghhhhtttt....sssswwww....ppppuuuubbbblllliiiicccc
  345.                    IIIInnnnsssstttt>>>> ggggoooo
  346.  
  347.  
  348.                b.  If you are mounting the CD-ROM from a remote
  349.                    system, as root mount <_c_d-
  350.                    _s_e_r_v_e_r>:/_C_D_R_O_M/_i_n_s_i_g_h_t/_S_G_I__b_o_o_k_s_h_e_l_v_e_s on
  351.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s. You
  352.                    may need to create the directory
  353.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s if it
  354.                    doesn't exist.
  355.  
  356.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  357.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss \\\\
  358.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  359.  
  360.                c.  If you are mounting the CD-ROM from a remote
  361.                    system, mount <_c_d-_s_e_r_v_e_r>:/_C_D_R_O_M/_h_e_l_p on
  362.                    /_u_s_r/_s_h_a_r_e/_h_e_l_p. You may need to create the
  363.                    directory /_u_s_r/_s_h_a_r_e/_h_e_l_p if it doesn't exist.
  364.  
  365.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  366.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  367.  
  368.  
  369.  
  370.        2.6.4  _C_r_e_a_t_i_n_g__a_n__I_n_S_i_g_h_t__D_o_c_u_m_e_n_t__S_e_r_v_e_r
  371.  
  372.        For sites with numerous IRIS machines running multiple
  373.        versions of the operating system, it may be advantageous to
  374.        devote one machine to being an InSight Document Server.
  375.        This server would contain all the books for the various OS
  376.        releases, and the clients would simply NFS mount the
  377.        appropriate books and help from that server.
  378.  
  379.        To create a document server, start by installing the version
  380.        of InSight and all the books for the oldest OS version that
  381.        any client machine will want to mount.  For instance, if the
  382.        server will contain the 4.0.5, 5.2, and 5.3 books, then
  383.        install the 4.0.5 version of InSight and the 4.0.5 books
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                   - 7 -
  396.  
  397.  
  398.  
  399.        first.
  400.  
  401.        For 4.0.5 the books are installed in /_u_s_r/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y.
  402.        After they are installed move the "library" directory to
  403.        "4.0.5library" so that the next install doesn't remove the
  404.        books.  Later on after you have installed the other OS
  405.        bookshelves you may want to move the "4.0.5library"
  406.        directory to the location that the other library directories
  407.        will be under /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t.
  408.  
  409.        ssssuuuu
  410.        ccccdddd ////uuuussssrrrr////IIIInnnnssssiiiigggghhhhtttt
  411.        mmmmvvvv lllliiiibbbbrrrraaaarrrryyyy 4444....0000....5555lllliiiibbbbrrrraaaarrrryyyy
  412.  
  413.        Next install the 5.2 versions of InSight and the books.
  414.        Under 5.2 the books were installed in
  415.        /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y.  So after you have installed all
  416.        the 5.2 books you need to move the "library" directory to
  417.        "5.2library".  For 5.2 we added application specific help so
  418.        you also need to preserve the helpmap files that are
  419.        specific to 5.2 applications so go to /_u_s_r/_s_h_a_r_e and move
  420.        the "help" directory to "5.2help".
  421.  
  422.        ssssuuuu
  423.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt
  424.        mmmmvvvv lllliiiibbbbrrrraaaarrrryyyy 5555....2222lllliiiibbbbrrrraaaarrrryyyy
  425.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee
  426.        mmmmvvvv hhhheeeellllpppp 5555....2222hhhheeeellllpppp
  427.  
  428.        Finally install the 5.3 versions of InSight and the books.
  429.        After you have installed all the 5.3 books you need to move
  430.        the "library" directory to "5.3library".  You also need to
  431.        preserve the helpmap files that are specific to 5.3
  432.        applications so go to /_u_s_r/_s_h_a_r_e and move the "help"
  433.        directory to "5.3help".
  434.  
  435.        ssssuuuu
  436.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt
  437.        mmmmvvvv lllliiiibbbbrrrraaaarrrryyyy 5555....3333lllliiiibbbbrrrraaaarrrryyyy
  438.        ccccdddd ////uuuussssrrrr////sssshhhhaaaarrrreeee
  439.        mmmmvvvv hhhheeeellllpppp 5555....3333hhhheeeellllpppp
  440.  
  441.        Follow this process for any version of the books you want to
  442.        install on the server.  If you ever need to install more
  443.        books on a specific OS bookshelf then create a symbolic link
  444.        from the proper "library" directory to the OS specific
  445.        library directory.  For 5.X help books you will also need to
  446.        create a link for the "help" directory as well.
  447.  
  448.        Here is what a Document Server would look like after
  449.        installing the 4.0.5, 5.2, and 5.3 books:
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                   - 8 -
  462.  
  463.  
  464.  
  465.        ssssuuuu
  466.        %%%% llllssss ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt
  467.  
  468.        ttttoooottttaaaallll 22224444
  469.        ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11116666::::22226666  4444....0000....5555lllliiiibbbbrrrraaaarrrryyyy
  470.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 MMMMaaaayyyy 22226666 11116666::::44441111  5555....2222lllliiiibbbbrrrraaaarrrryyyy
  471.        ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  5555 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11118888::::44441111  5555....3333lllliiiibbbbrrrraaaarrrryyyy
  472.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 SSSSeeeepppp 11113333 11118888::::22221111  lllliiiibbbb
  473.        llllrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  1111 rrrrooooooootttt  ssssyyyyssss  11110000  OOOOcccctttt 22226666 11116666::::33331111  lllliiiibbbbrrrraaaarrrryyyy ---->>>> 5555....3333lllliiiibbbbrrrraaaarrrryyyy
  474.        ----rrrr--------rrrr--------rrrr--------  1111 rrrrooooooootttt  ssssyyyyssss  222299990000 SSSSeeeepppp 11113333 11117777::::55556666  ssssyyyysssstttteeeemmmm....iiiinnnnssssiiiigggghhhhttttrrrrcccc
  475.        ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrrwwwwxxxx  2222 rrrrooooooootttt  ssssyyyyssss  555511112222 OOOOcccctttt 22226666 11114444::::22228888  ttttmmmmpppp
  476.  
  477.        %%%% llllssss ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////****hhhheeeellllpppp
  478.  
  479.        ttttoooottttaaaallll 22224444
  480.        ddddrrrrwwwwxxxxrrrr----xxxxrrrr----xxxx  3333 rrrrooooooootttt  ssssyyyyssss  555511112222 MMMMaaaayyyy 22226666 11116666::::44441111  5555....2222hhhheeeellllpppp
  481.        ddddrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  5555 rrrrooooooootttt  ssssyyyyssss  555511112222 AAAAuuuugggg  2222 11118888::::44441111  5555....3333hhhheeeellllpppp
  482.        llllrrrrwwwwxxxxrrrrwwwwxxxxrrrr----xxxx  1111 rrrrooooooootttt  ssssyyyyssss  11110000  OOOOcccctttt 22226666 11116666::::33331111  hhhheeeellllpppp ---->>>> 5555....3333hhhheeeellllpppp
  483.  
  484.        After the server is set up, all the various OS specific
  485.        clients need to do is install the proper InSight software on
  486.        their system and NFS mount the OS specific library and help
  487.        directory.  Follow the instructions in the OS specific
  488.        release notes for how to install for a "Client with a Remote
  489.        Server" except mount the OS specific version of the
  490.        libraries rather than the "library" directory.
  491.  
  492.        The following illustrates the specific mount commands a
  493.        client would use given the sample Document Server specified
  494.        above.
  495.  
  496.        For an IRIX 5.3 client:
  497.  
  498.        ssssuuuu
  499.        #### mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////5555....3333lllliiiibbbbrrrraaaarrrryyyy ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  500.        #### mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////5555....3333hhhheeeellllpppp            ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  501.  
  502.        For an IRIX 5.2 client:
  503.  
  504.        ssssuuuu
  505.        #### mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////5555....2222lllliiiibbbbrrrraaaarrrryyyy ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  506.        #### mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////5555....2222hhhheeeellllpppp            ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  507.  
  508.        For an IRIX 4.0.5 client:
  509.  
  510.        ssssuuuu
  511.        #### mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////4444....0000....5555lllliiiibbbbrrrraaaarrrryyyy ////uuuussssrrrr////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  512.  
  513.        Under 4.0.5 "help" was not available; this was an additional
  514.        product that released after IRIX 4.0.5.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.                                   - 9 -
  528.  
  529.  
  530.  
  531.        Note:  Do not attempt to NFS mount 5.3 books and 5.3 help
  532.               onto a 5.2 OS system if you expect the help to
  533.               function for the 5.2 applications.  The helpmaps are
  534.               tuned to the specific version of the application and
  535.               the book content and both have changed between 5.2
  536.               and 5.3.  The same problem will occur if you attempt
  537.               to access 5.2 books and help from 5.3 applications.
  538.  
  539.  
  540.        2.6.5  _C_l_i_e_n_t__A_c_c_e_s_s_i_n_g__B_o_o_k_s__f_r_o_m__M_u_l_t_i_p_l_e__L_o_c_a_t_i_o_n_s
  541.  
  542.        It is possible to access books from multiple locations in
  543.        IRIS InSight.  This is useful, for example, if you want to
  544.        access the books available on the IRIX 5.3 CD-ROM along with
  545.        the books installed locally on your system disk.  Due to the
  546.        complexity of this configuration, this kind of setup should
  547.        only be attempted by InSight administrators that understand
  548.        the intricacies of InSight book administration.  We
  549.        recommend that you instead set up an InSight Document Server
  550.        as mentioned in the previous section.
  551.  
  552.        To do so involves making the appropriate mounts and links in
  553.        the /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y directory so that InSight
  554.        will find the books.  IRIS InSight assumes that every
  555.        subdirectory of /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s
  556.        is a directory of bookshelves. For example, you may find a
  557.        directory called "SGI_EndUser" containing the end user
  558.        books.
  559.  
  560.        Note:  If you have any of the European language books
  561.               installed then "SGI_bookshelves" will be
  562.               "de_bookshelves" for the German version of the books
  563.               and "fr_bookshelves" for the French versions of the
  564.               books.
  565.  
  566.        Each bookshelf directory contains a set of books, via
  567.        subdirectories and files.  It is important to note that each
  568.        bookshelf is an integral unit and you cannot access
  569.        individual books on it via links.  However, you can
  570.        configure the books available on a bookshelf by selecting or
  571.        deselecting the appropriate books through _i_n_s_t.
  572.  
  573.        To add a new bookshelf to IRIS InSight, it is sufficient to
  574.        make a link or mount a bookshelf directory in
  575.        /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s.
  576.  
  577.        For example, if you don't have the SGI_Admin bookshelf
  578.        installed on your hard disk and you want to access it
  579.        directly from the IRIX 5.3 CD-ROM, do the following:
  580.  
  581.        ssssuuuu
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.                                   - 10 -
  594.  
  595.  
  596.  
  597.        llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn \\\\
  598.        ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn
  599.  
  600.        Note:  These instructions assume the CD-ROM is mounted as
  601.               /_C_D_R_O_M.
  602.  
  603.        The next time IRIS InSight is started it will now read the
  604.        SGI_Admin bookshelf from the CD-ROM along with any books
  605.        that were already on your hard disk.
  606.  
  607.        In this manner, any number of bookshelves may be added or
  608.        removed from IRIS InSight.
  609.  
  610.  
  611.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  612.  
  613.        After the software has been installed, you might want to
  614.        force your shell to re-cache its list of known executables:
  615.  
  616.        rrrreeeehhhhaaaasssshhhh
  617.  
  618.        You can then execute the IRIS InSight Viewer.  It is known
  619.        as _i_n_s_i_g_h_t, or _i_i_v for short.  _i_i_v stands for IRIS InSight
  620.        Viewer.  The Viewer process places itself in the background
  621.        by default.
  622.  
  623.        iiiiiiiivvvv
  624.  
  625.        You should never have to explicitly execute the sgihelp
  626.        process.  It will automatically start when a help request is
  627.        made from another application (via a ``Help'' menu item,
  628.        ``Help'' pushbutton, or a direct message).
  629.  
  630.        You should never have to explicitly execute the desktophelp
  631.        process from a shell. It can be started from the Toolchest
  632.        under ``Help - Desktop Help''. Once started, it will
  633.        communicate directly with the sgihelp process (Desktop Help
  634.        Server) and issues a request for the server to display the
  635.        Desktop Help Index.
  636.  
  637.        After the desktophelp process issues the command, the
  638.        process quits.
  639.  
  640.        Note that the sgihelp process should be present (installed)
  641.        on the user's machine for this to work. If it is not
  642.        installed, a warning will be issued to the user. However,
  643.        the sgihelp process does not need to be running for the
  644.        request to be made. It will be started automatically.
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                   - 11 -
  660.  
  661.  
  662.  
  663.        2.8  _M_a_i_n_t_e_n_a_n_c_e__A_f_t_e_r__R_e_m_o_v_i_n_g__B_o_o_k_s
  664.  
  665.        Installation of books runs several commands during the
  666.        exitop phase to create a library level index for each
  667.        bookshelf.  Unfortunately if you remove books using the
  668.        _v_e_r_s_i_o_n_s _r_e_m_o_v_e command the books are removed but the
  669.        library level index is not updated.  To bring the library
  670.        level index back up to date invoke the _i_n_s_i_g_h_t_A_d_m_i_n command
  671.        on the specific bookshelf the book was removed from or all
  672.        the bookshelves.  See the man page for _i_n_s_i_g_h_t_A_d_m_i_n for more
  673.        details.
  674.  
  675.        iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----aaaaffff ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////****
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.